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14.36 SubschbeFilter 

<l Previous: 14.35 Subscribe 



<result> - subscribeFilter (<cm/s_f«er_sfr/ng>) ; where <c/n/s_f/7ter_sWng> is a CMIS filter 
construct of type OCTET STRING. 

<result> - subscribeFilter (<asnY_cm/s_f/fter>) ; where <asn1_cmis_filter> is a CMIS filter 
construct of type Asnivalue. 

Return Value: INTEGER. <result> is a a handle of type INTEGER. If there is a failure that prevents 
implementation of the subscription, -i is returned. Othenwise, a handle index is returned; this handle can be 
passed to the unsubscribe () function to terminate the subscription. 

It is recommended that you check for a return value of -1 to determine if errors have been encountered. For 
example, if the syntax of the CMIS filter passed as <cmis_mer_string> is incorrect, -i will be returned. 

This command subscribes for events that match the specified CMIS filter. If an event passes the filter, it will 
be foHA/arded to the request. The CMIS filter can be passed to the function either as a string or as an ASN.1 
value. For information on the format of a CMIS filter, refer to the "CMIS Scoping and Filtering" appendix in the 
Solstice Enterprise Manager Reference Manual. 



Note - If you want to use the unsubscribe ( ) function to turn off a subscription created with the 
subscribeFilter 0 function, you cannot invoke unsubscribe () in a condition that is evaluated as the 
result of an event received on this subscription. Your request should transition to another state before calling 
the unsubscribe 0 function. 



Considerations 

If you invoke two subscriptions using CMIS filters and one filter selects a subset of the other, your 
request will receive duplicate events for the overlapping subset. An example of this would be the 
following two subscriptions: 



$index = subscribeFilterfCMIP-l .CMISFilter";'or: {item: 
equality: {objectClass,mosi}. item: equality: {eventType, 
internetAtarm}}"); 
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$index = subscribeFilter{"CMIP-1.CMISFilter". "item: equality: 
{eventType, InternetAlarm}"); 

If these two subscriptions are invoked, each incoming internetAlarm is forwarded twice to the request. You 
should tailor your event subscriptions so as to avoid this duplication of events. 

When a subscription is created using a CMIS filter, every event in the system is checked against that 
filter. Additional filter subscriptions thus place an increasing load on the MIS. To avoid an adverse 
impact on performance, it is recommended that you exercise care in the use of filter subscriptions. 

Examples 

. The following is an example of a subscription that passes a CMIS filter that forwards all events to a 
request: 



$index = subscribeFilter("and : { }"); 
This same CMIS filter could be passed as an ASN.1 value: 



$f!lter = strToAsn("CMIP-1 .CMISFilter"/'and : { }"); 
$index = $ubscribeFilter($filter); 

A CMIS filter could be used to forward all events of a specified managed object class to the request. For 
example, ail nerveCenterAlarm, generated using the RCL alarm-logging functions (alarm ( ) , 
alarmoi ( ) , alarmstr ( ) )s are instances of a managed object class called mosi. The following filter 
forwards to the request all events whose managed object class is mosi. 



Sfilter = strToAsn("CMIP-1.CMISFilter". "item: equality 

{managedObjectClass, mosi}"); 

$index = subscribeFilter($filter); 

This same CMIS filter could be passed as a string: 



$index = subscribeFilter("item: equality {managedObjectClass, 

.[O^iiElii. _ —— — — 

The following example uses a CMIS filter that selects all events whose managed object class is system 
and whose eventType is communicationsAlarm: 



Sfilter = strToAsn("CMiP-1 .CMISFilter", "and: {item: equality: 

{managedObjectClass, system}, item: equality: {eventType, 

communicationsAlarm}}"); 

Sindex = subscribeFilte r ($filte r); ^ 
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